Practical Internet 2001 August/Practical Internet August 2001.iso/Software/Full/NetTracker/UTIL/READNT.TXT

Text File | 2001-10-17 | 13.9 KB | 429 lines

Welcome
-------

Thank you for using NetTracker 3.5. We have tried to make NetTracker
3.5 as easy to use as possible. We have also tried to incorporate many
powerful features into this version of NetTracker. However, we always
welcome new ideas and suggestions to make NetTracker even easier to use
and more powerful. Please e-mail your suggestions to [e-mail].
Please read this entire document before installing NetTracker.

Thank you.

The NetTracker Development Team
Another Sane Solution

Installation
------------

To install NetTracker follow these simple steps:

   1. Log on to the server console with administrative access
      rights.

   2. Double-click on the NetTracker self-extracting archive.

   3. Follow the on-screen instructions.

To configure NetTracker follow these simple steps:

 NetTracker Standard and Professional:

   1. Open your web browser and pull up the URL from the end of
      the install.

   2. Click on options in the top frame to configure NetTracker.

   3. Click on General in the left frame to setup your report
      options.  You must set the "Name of organization:" and
      "URL of the site being analyzed:" options. After you have
      entered appropriate values click Save Options below.

   4. Click on "Log Files" in the left frame to tell NetTracker
      what log files to process. Click Add to add another log
      file.  Select the log file type on the left and enter the
      full path to the log file on the right. Next, click Add.

   5. Other options are not required and can be left set to
      their defaults.

   6. To import your log data and generate a report now click
      the Update button in the top frame.

   7. For additional configuration, see the user's manual or the
      on-line help.

 NetTracker Enterprise and ISP:

   1. Open your web browser and pull up the URL from the end of
      the install.

   2. Click on the New Report button.

   3. Enter a short report name for your report and then click
      enter.  You will then be presented with the options screen
      for the report you are setting up.

   4. Click on General in the left frame to setup your report
      options.  You must set the "Name of organization:" and
      "URL of the site being analyzed:" options. After you have
      entered appropriate values click Save Options below.

   5. Click on "Log Files" in the left frame to tell NetTracker
      what log files to process. Click Add to add another log
      file.  Select the log file type on the left and enter the
      full path to the log file on the right. Next, click Add.

   6. Other options are not required and can be left set to
      their defaults.

   7. To import your log data and generate a report now click
      the View Report button. When the report is displayed
      click Update.

   8. For additional configuration, see the user's manual or the
      on-line help.

Upgrading from NetTracker 3.0
-----------------------------
The following upgrade paths are possible:

NetTracker 3.0 -> NetTracker 3.5
NetTracker 3.0 Professional -> NetTracker 3.5 Professional
NetTracker 3.0 Enterprise -> NetTracker 3.5 Enterprise

To upgrade using one of the above upgrade paths:

   1. Make sure no NetTracker reports are currently running.

   2. Backup your current NetTracker installation.

   3. Log on to the server console with administrative access rights.

   4. Double-click on the NetTracker self-extracting archive.

   5. When prompted enter your serial number and activation key.

   6. When the installation prompts you for the NetTracker program
      directory enter your current NetTracker program directory.

   7. NetTracker will now update your current NetTracker installation.

Note:  When upgrading from NetTracker 3.0 to NetTracker 3.5 only
configuration settings can be imported.  Any log data that has previously
been imported will have to be reimported.

Upgrading between different versions of NetTracker 3.5
------------------------------------------------------
The following upgrade paths are possible:

NetTracker 3.5 -> NetTracker 3.5 Professional
NetTracker 3.5 -> NetTracker 3.5 Enterprise
NetTracker 3.5 Professional -> NetTracker 3.5 Enterprise

   1. Make sure no NetTracker reports are currently running.

   2. Backup your current NetTracker Installation.

   3. Log on to the server console with administrative access rights.

   4. Double-click on the NetTracker self-extracting archive.

   5. When prompted enter your serial number and activation key.

   6. When the installation prompts you for the NetTracker program
      directory enter your current NetTracker program directory.

   7. NetTracker will now update your current NetTracker installation.

Note:  When upgrading between different versions of 3.5 configuration
settings and log data is imported.  After completing the upgrade process
your NetTracker reports have to be regenerated.

Browser Configuration
---------------------
It is recommended that you configure your web browser in the following
way:

Netscape Navigator 3.0:

    1. Go to Network Preferences which is under the Options Menu

    2. Click on the cache tab.

    3. Set Verify Documents to every time.

Netscape Communicator 4.0:

    1. Go to Preferences, which is under the Edit menu.

    2. Double-Click on advanced under Category.

    3. Click on cache.

    4. On the right set "document is compared to document on network" to
       "every time".

Microsoft Internet Explorer 3.X:

    1. Go to Options which is under the View Menu

    2. Click on the advanced tab.

    3. On the advanced page, under temporary internet files click the
       settings button.

    4. Set "check for new versions of stored pages" to "every visit to
       the page".

    5. Click OK

Microsoft Internet Explorer 4.X:

    1. Go to Internet Options which is under the View Menu

    2. Click on the general tab.

    3. Under temporary internet files click the settings button.

    4. Set "check for new versions of stored pages" to "every visit
       to the page".

    5. Click OK

Server Configuration
--------------------

For optimal performance, it is recommended that you configure your web
server in the following ways:

Host Name Resolution

We strongly recommend that you configure your web server to resolve host
names instead of having NetTracker resolve them.  For more information on
this, please consult your web server documentation.

Mime Types

NetTracker can export data, allowing users to import NetTracker reports
into popular software products such as Microsoft Excel, Access and Word.
NetTracker uses the .csv file extension when exporting data.  For optimal
performance, it is recommended that you add the mime type
"application/octet-stream" for the file extension ".csv".  For more
information on this, see the server specific release notes below.

Password Protection

NetTracker does not come with any type of built in password protection to
restrict access from unauthorized individuals.  Instead, we leave this
task up to you to implement using your web server's built in password
protection.

Report Automation (For Windows NT 4.0 Servers)

NetTracker comes with a command line utility, NetTracker.exe, which can be
used to automatically generate reports each night.  The easiest way to
configure this option is to use the Windows NT schedule service.  If the
schedule service is not running on your computer, you will have to go to
Services in the Control Panel and set it up to start automatically.  Once
the schedule service is running you can use the AT command from the MS-DOS
command prompt to schedule a job.  For example, to update your report each
night at 11:00PM, use the AT command:

    Standard and Professional Editions:
AT 11:05PM /every:m,t,w,th,f,sa,su "c:\Program Files\NetTracker\nettracker.exe"
reports -quiet -dir "c:\Program Files\NetTracker"

    Enterprise and ISP Editions:
AT 11:05PM /every:m,t,w,th,f,sa,su "c:\Program Files\NetTracker\nettracker.exe"
all -quiet -dir "c:\Program Files\NetTracker"

Command Line Options
--------------------

NetTracker 3.5 and NetTracker 3.5 Professional:

   Usage: nettracker reports [options]

    -abort               Aborts the report
    -clear               Clears the database
    -debug               Instructs NetTracker to print debugging information
    -dir <dir>           Specify the NetTracker program directory
    -quiet               Instructs NetTracker not to print anything
    -recalc              Recalculates the report databases from the imported data
    -regen               Regenerates the HTML report files
    -reindex             Reindexes the database

NetTracker 3.5 Enterprise:

   Usage: nettracker <short report name> [options]

    -abort               Aborts the report
    -clear               Clears the database
    -debug               Instructs NetTracker to print debugging information
    -dir <dir>           Specify the NetTracker program directory
    -quiet               Instructs NetTracker not to print anything
    -recalc              Recalculates the report databases from the imported data
    -regen               Regenerates the HTML report files
    -reindex             Reindexes the database

    Note: <short report name> can be replaced with "all" to update all
          reports, or "admin" to update only the server wide reports.

Server Specific Notes
---------------------

Microsoft Internet Information Server

How to Log to IIS Extended Log Format in IIS 2.0/3.0:

   An ISAPI filter is available from Sane Solutions.

   1. To install Double-click on Sane Extended Logging Filter Installation
      Program.

   2. Follow on-screen instructions.

   3. Stop and restart the "World Wide Web Publishing Service"

Logging in IIS 4.0

   We recommend logging to the W3C format when using IIS 4.0.

For the NetTracker export function to work properly it is necessary to
setup a mime type for .csv files in Windows NT 4.0.  The following
steps are necessary to accomplish this:

1. Start Windows Explorer

2. Select View - Options from the menu bar.

3. Click on the File Types Tab.

4. Click the New Type Button.

5. Fill out the Add New File Type window with the following information:
       Description of Type: Comma Separated Value
       Associated Extension: .csv
       Content_Type (MIME): application/octet-stream

6. Click OK

7. If you get a message that the .csv extension is already in use, you
   will have to search through the file-types to find what is associated
   with .csv files.
   If you do not get any error messages you are done.

8. Assuming that you received an error message, find what is associated
   with .csv files and click edit.

9. Add the following:
       Content_Type (MIME): application/octet-stream

10. Click OK.

11. You are done.


Netscape FastTrack/Enterprise

For the NetTracker export function to work properly it is necessary to
edit the server mime.types file. The following steps are necessary to
accomplish this:

1. Change to the directory in which the configuration files are located
   for the server on which you installed NetTracker.
   The default path would likely be:
   c:\Netscape\server\httpd-<server name>\config\

2. Open the file mime.types with notepad.

3. Look for the line:
       type=application/octet-stream  ext=bin

4. Change it to read:
       type=application/octet-stream  ext=bin,csv

5. Restart the Server.

Logging with Netscape servers:

With Netscape servers we recommend that you log to Netscape
Flexible Log Format and turn on the following options:

    Log client accesses?
        Yes
    Record:
        Domain Names
    Format:
        Only log: (Turn on the following fields)
            ╖ Client hostname
            ╖ Authenticate user name
            ╖ System date
            ╖ Full request
            ╖ Status
            ╖ Content length
            ╖ HTTP header, "referer"
            ╖ HTTP header, "user-agent"

Note:

On both FastTrack and Enterprise servers CGI is NOT setup by default.
If you have not already done so it will be necessary to setup a cgi-bin
directory.


WebSite

For the NetTracker export function to work properly it is necessary to
setup a mime type for .csv files in Windows NT 4.0.  The following
steps are necessary to accomplish this:

1. Start Windows Explorer

2. Select View - Options from the menu bar.

3. Click on the File Types Tab.

4. Click the New Type Button.

5. Fill out the Add New File Type window with the following information:
        Description of Type: Comma Separated Value
        Associated Extension: .csv
        Content_Type (MIME): application/octet-stream

6. Click OK

7. If you get a message that the .csv extension is already in use, you
   will have to search through the file-types to find what is associated
   with .csv files.
   If you do not get any error messages you are done.

8. Assuming that you received an error message, find what is associated
   with .csv files and click edit.

9. Add the following:
        Content_Type (MIME): application/octet-stream

10. Click OK.

11. You are done.


Lotus Notes 4.6+

By default logging is turned off in Notes.  You will need to turn on
logging in your http server configuration.  Under "Enable Logging To:",
select  enabled to the right of "Log Files:"

Lotus Notes logs agent and referrer information to separate files from
the main log file.  For NetTracker to correctly analyze these logs they
must all be in the same directory and only the access log should be
specified in the NetTracker options.   NetTracker also requires that the
agent and referrer logs follow the Lotus Notes naming convention.

Since the logging is separated into 3 files, be sure to rotate all three
files at the same time.